home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / programs / astro / AC9117_1.ZIP / ASTROCLK.NEW < prev    next >
Text File  |  1991-04-22  |  10KB  |  154 lines
  1.         ASTROCLK REVISION HISTORY
  2.  
  3.              Each released version of ASTROCLK uses a four digit revision 
  4.         code such as 9117. The first two digits indicate the year      
  5.         and the second two digits indicate the week of the year. In some      
  6.         cases, an additional letter suffix is added to distinguish      
  7.         changes occuring within the same week. A partial week at the      
  8.         beginning or end of the year is counted as a full week. Using      
  9.         this method, a year will typically have 53 weeks although it is      
  10.         possible to have 54 weeks in a leap year (1972 is an example).      
  11.         The current year-week revision code is shown on the Julian Date      
  12.         display, Display Mode 7, in ASTROCLK.
  13.              This file records the recent revision history of program      
  14.         ASTROCLK through all of the minor twists and turns that usually      
  15.         accompany the evolution of such a program. (Early revision notes      
  16.         have been deleted from this file but are available on request.)      
  17.         It illustrates the tortuous process of maintaining and refining a      
  18.         program as ideas and problems are reported from every quarter. It      
  19.         may also be helpful to users who are upgrading from one version      
  20.         to another to find out what has changed. This file may also      
  21.         describe recent changes not included in the main documentation;      
  22.         compare the version numbers below with the main documentation.
  23.  
  24.                                                 David H. Ransom, Jr.
  25.  
  26.  
  27.         9117     04/22/91
  28.         -----------------
  29.         -This release is a MAJOR UPGRADE from Version 9050.
  30.  
  31.         NOTE:     ASTROCLK now requires binary external star catalogs 
  32.                   which have a filetype of ".CC1". ASTROCLK's external 
  33.                   catalog star searches (Function Key F5) will NOT 
  34.                   operate correctly with prior versions of the external 
  35.                   star catalogs! See below.
  36.  
  37.         -Added a sixth mode to the Precision Data Displays (Display Mode      
  38.         8) to show the local times for sunrise, sunset, and Civil, 
  39.         Nautical, and Astronomical twilight. Thanks to Matt Merrill for 
  40.         writing and debugging the original code which I then then adapted 
  41.         for use in ASTROCLK.
  42.         -Changed external star catalog from ASCII to binary format,      
  43.         identified by the filetype ".CC1".. The new supplied catalog      
  44.         names are ASTROCLK.CC1 and MESSIER.CC1. Catalog searches now      
  45.         require approximately one half the search time and the binary      
  46.         catalogs are less than half the size of the previous ASCII 
  47.         versions. Binary catalogs are created by my program STARCAT which 
  48.         will be available on my BBS. Other star catalogs may be available 
  49.         in a binary format for use with ASTROCLK.
  50.         -Edited ASTROCLK.CC1 and MESSIER.CC1 to delete the all-zero      
  51.         "place holder" which occupied the record for the non-existent      
  52.         Messier object M40. This caused an incorrect match on star      
  53.         searches near RA=0 and DEC=0. However, this means that the 
  54.         catalog number (when searching MESSIER.CC1 by catalog number 
  55.         rather than by object name) for Messier objects greater than 40 
  56.         will be one less than the Messier number.
  57.         -Corrected an error in angular separations during star searches      
  58.         if right ascension were set to zero.
  59.         -Added AUTO mode to DAYLIGHT FLAG, set using ALT-F10+F1. After      
  60.         pressing ALT-F10, press F1 repeatedly until the desired DAYLIGHT      
  61.         FLAG mode is displayed: "[OFF]", "[ON]", or "[AUTO ON]"/"AUTO      
  62.         OFF]". Note that when the AUTO mode is selected, the state of the      
  63.         DAYLIGHT FLAG ("ON" or "OFF") is selected based upon the current      
  64.         DOS date and time. Do not select the AUTO mode if your location      
  65.         does not use daylight time!
  66.         -When set to the AUTO mode, the DAYLIGHT FLAG will be set or      
  67.         reset automatically and the local time zone clock display title      
  68.         (Display Mode 1) will change from standard to daylight time or      
  69.         vice versa. Daylight time is ENABLED as of 02:00 on the first      
  70.         Sunday in April; daylight time is DISABLED as of 02:00 on the      
  71.         last Sunday in October. These dates are valid ONLY for the United      
  72.         States and Canada; all other users should set the DAYLIGHT FLAG      
  73.         to ON or OFF manually to correspond to daylight or summer time      
  74.         conventions in their location. NOTE: Systems with an 80286 
  75.         processor or higher AND using DOS Version 3.3 or higher will also      
  76.         change the hardware clock when using the AUTO mode. For these      
  77.         systems, including ASTROCLK in the AUTOEXEC.BAT file and setting      
  78.         the DAYLIGHT FLAG to the AUTO mode will automatically adjust the      
  79.         computer hardware and software clocks for daylight time changes      
  80.         at boot-up.
  81.         -Changing the DAYLIGHT FLAG using ALT-F10+F1 or allowing the      
  82.         DAYLIGHT FLAG to be changed in the AUTO mode now automatically      
  83.         adjusts the UTC OFFSET to reflect the time change. In prior      
  84.         versions, the UTC OFFSET had to be manually changed using F10+F10      
  85.         every time the DAYLIGHT FLAG was changed.
  86.         -Repaired minor bug with INTERVAL TIMER. If the DAYLIGHT FLAG was      
  87.         changed while the timer was on, the timer was in error by one      
  88.         hour. The timer start time is now automatically adjusted if the      
  89.         DAYLIGHT FLAG is changed either manually or automatically.
  90.         -Modified Perpetual Calendar, Display Mode 6. When the calendar      
  91.         is displayed, pressing the digit 6 will toggle between the 
  92.         calendar display and a list of the holidays in that month. 
  93.         Several additional holidays plus the beginning and end of 
  94.         Daylight Savings time added. Corrected taxes due date so that it 
  95.         does not occur on Saturday or Sunday but on the following Monday.
  96.         -Adjusted DD/MM/YYYY date input error checking using F3 to 
  97.         properly check the day for each month (beginning with day 1) but 
  98.         to allow January 0 and December 32 to correspond with common 
  99.         usage and the Astronomical Almanac. Prior versions allowed the 
  100.         0th of any month and disallowed December 32.
  101.         -Corrected date input using F3 to agree with documentation such      
  102.         that using the form "+nnn" adds nnn days to the current Julian      
  103.         Date. Prior versions assumed absolute Julian Date if nnn was      
  104.         greater than 50 even if the "+" was included. Absolute Julian      
  105.         Date is now assumed only if nnn is greater than 400 AND the "+"      
  106.         sign is omitted.
  107.         -Corrected bug in external star catalog searches. If one of the      
  108.         nearby stars were selected instead of the nearest star, the      
  109.         program aborted with a "Bad file name or number" error. This was      
  110.         still another (but never reported) file handle error introduced      
  111.         at Version 9016!
  112.         -Corrected cosmetic problem with city file searches using F6.      
  113.         When the SPACE BAR was pressed to search for the next match, the      
  114.         prior city name was not cleared before next name was displayed.      
  115.         If the next city name was shorter than the previous city name,      
  116.         excess characters were "left over" on the display.
  117.         -Corrected minor bug in city file searches: if no city was 
  118.         accepted, elevation for the current location was reset to zero.
  119.         -Updated ASTROCLK.MPC to use the first 250 minor planets from      
  120.         file ELEM911.MPC (as of February 1991).
  121.         -File ASTROCLK.CTY corrected. "West Covina" was mispelled as      
  122.         "West Corina", and the coordinates for Sunnyvale, CA have been      
  123.         updated (per Mike Gardner). Added Greenwich Obs, England for      
  124.         easier checking of Greenwich-based data along with several other      
  125.         cities whose coordinates were sent in by users.
  126.         -Moved some code to new ASTROSB4.BAS SUB and FUNCTION source file      
  127.         to fix compiler memory overflow for main module. Added source      
  128.         file ASTROCLK.INC, an include file with DIM, COMMON and CONST      
  129.         statements used by all other source files.
  130.  
  131.         9050     12/14/90
  132.         -----------------
  133.         -Added UTC Day-of-Year to Display Mode 7 for years > 1949. This 
  134.         is the format used by NORAD with 2-line orbital elements, i.e. 
  135.         90247.451472. The first two digits are the year, then the day of 
  136.         the year, and the time is the fractional part of the day. This is 
  137.         the time/date format required by satellite tracking programs such 
  138.         as STSORBIT and TRAKSAT.
  139.         -Adjusted Delta-T and Delta-AT in accordance with revised data in 
  140.         the 1991 Astronomical Almanac and to take into account the Leap 
  141.         Second at the end of 1990. The change in Delta-T amounts to about 
  142.         0.2 seconds for 1989, 1990 and subsequent years.
  143.         -Changed .CTY file format to include elevation in meters. Do NOT 
  144.         use OLD .CTY files without editing each line to add ",0" (without 
  145.         the quotation marks) at the end for elevation. Or substitute the 
  146.         elevation in meters if known.
  147.         -Added feature to append new local coordinates entered with F6 to 
  148.         the current CITYFILE.
  149.         -Extensive revisions to the documentation to bring it up to date 
  150.         from Version 8947. This was such a chore that I will resume 
  151.         updating the documentation at every revision. It is likely that 
  152.         I've missed some corrections in this process; if in doubt, 
  153.         consult these notes.
  154.